8. get_latest_by

Model source code

from django.core import meta

class Article(meta.Model):
    headline = meta.CharField(maxlength=100)
    pub_date = meta.DateTimeField()
    class META:
        get_latest_by = 'pub_date'

    def __repr__(self):
        return self.headline

API reference

Article objects have the following methods:

• delete()
• get_next_by_pub_date()
• get_previous_by_pub_date()
• save()

Sample API usage

This sample code assumes the above model has been saved in a file examplemodel.py.

>>> from django.models.examplemodel import articles

# Because no Articles exist yet, get_latest() raises ArticleDoesNotExist.
>>> articles.get_latest()
Traceback (most recent call last):
    ...
ArticleDoesNotExist: Article does not exist for {'order_by': ('-pub_date',), 'limit': 1}

# Create a couple of Articles.
>>> from datetime import datetime
>>> a1 = articles.Article(id=None, headline='Article 1', pub_date=datetime(2005, 7, 26))
>>> a1.save()
>>> a2 = articles.Article(id=None, headline='Article 2', pub_date=datetime(2005, 7, 27))
>>> a2.save()
>>> a3 = articles.Article(id=None, headline='Article 3', pub_date=datetime(2005, 7, 27))
>>> a3.save()
>>> a4 = articles.Article(id=None, headline='Article 4', pub_date=datetime(2005, 7, 28))
>>> a4.save()

# Get the latest Article.
>>> articles.get_latest()
Article 4